#ifndef TTS_H
#define TTS_H

#include "types.h" // 需要用到 Song 结构体

/**
 * @brief 初始化TTS（文本转语音）SDK。
 * 必须在应用程序启动时调用一次。
 * @return 成功返回 true, 失败返回 false。
 */
bool initTTS_SDK();

/**
 * @brief 反初始化TTS SDK。
 * 必须在应用程序退出前调用一次以释放资源。
 */
void uninitTTS_SDK();

/**
 * @brief 生成并播放一首歌曲的语音播报。
 * 这是一个阻塞函数，它会等待播报结束后才返回。
 * @param song 要播报的歌曲对象。
 * @return 成功返回 true, 失败返回 false。
 */
bool playSongAnnouncement(const Song& song);

#endif // TTS_H